home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / tcp_ip / gp / 7plus.doc < prev    next >
Text File  |  1992-01-02  |  51KB  |  1,295 lines
  1.  
  2.  
  3.  
  4.  
  5.          ***************************************************************
  6.         ***                                                           ***
  7.         *** 7PLUS - Ein Filewandler mit Protokollierung und Reparatur ***
  8.         ***         durch den Store & Forward entstandener Fehler.    ***
  9.         ***                                                           ***
  10.         *** Version 1.50    Axel Bauda, DG1BBQ @DB0CL     (25.9.1991) ***
  11.         ***                      Potsdamer Str.43                     ***
  12.         ***                    W-2850 Bremerhaven 21                  ***
  13.         ***                                                           ***
  14.         *** 7PLUS ist Public Domain. Weitergabe nur zusammen mit      ***
  15.         *** 7PLUS.C und 7PLUS.DOC! Diese Anleitung gilt gleicher-     ***
  16.         *** massen für die IBM/ATARI_ST/AMIGA/UNIX-Version.           ***
  17.         ***                                                           ***
  18.          ***************************************************************
  19.  
  20.  
  21.         Die Anleitungs-Lese-Phobie (AntiDOCphobie):
  22.         ===========================================
  23.  
  24.         Immer wieder muss ich erleben, dass Fragen an mich gerichtet
  25.         werden, die ausführlich in dieser Anleitung erörtert sind!
  26.  
  27.         Ich weiss, dass es manchen Menschen schwer fällt, Anleitungen
  28.         sorgfältig zu lesen, aber es erspart mir einiges an unnötiger
  29.         Arbeit, wenn bei Problemen die Anleitung GENAU durchgelesen wird.
  30.  
  31.         Ich habe mir Mühe gegeben, diese Anleitung möglichst ausführlich zu
  32.         gestalten. Mit Sicherheit habe ich einige Punkte vergessen.
  33.  
  34.         Nobody's perfect.....
  35.  
  36.         Ich kann in dieser Anleitung keinen MS_DOS/ATARI/AMIGA oder UNIX-
  37.         Lehrgang mitliefern. Es sollten also zumindest die wichtigsten
  38.         Grundkenntnise zum Umgang mit dem eigenen Rechner vorhanden sein.
  39.  
  40.         Ebenfalls sollte der Umgang mit dem eigenen Terminalprogramm
  41.         beherrscht werden!
  42.  
  43.  
  44.         Vorwort:
  45.         ========
  46.  
  47.         Alle bisherigen Filewandler wie 7BIT, RADIX95, UUENCODE und auch
  48.         SEVEN gehen nicht, oder nur am Rande, auf die Tatsache ein, dass
  49.         das Packet-Radio-Netz nicht vollständig fehlerfrei arbeitet.
  50.         Hier setzt 7PLUS an, indem es die Korrektur beschädigter Dateien so
  51.         weit wie möglich automatisiert.
  52.  
  53.         Beispiel:
  54.  
  55.         OM A kodiert TEST.TXT zu TEST.7PL und spielt es in das S&F-Netz
  56.         ein.
  57.  
  58.         OM B liest TEST.7PL aus und versucht es zu dekodieren.
  59.  
  60.         ...Leider wurde das File auf dem Weg durch das Netz zerstört...
  61.  
  62.         7PLUS erkennt die Fehler in TEST.7PL beim Dekodieren und erzeugt
  63.         das Fehlerprotokoll TEST.ERR.
  64.  
  65.         OM B schickt TEST.ERR an OM A.
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.         OM A erzeugt damit die Korrekturdatei TEST.COR und spielt sie in
  79.         das Netz ein.
  80.  
  81.         OM B kann nun das defekte TEST.7PL mit Hilfe von TEST.COR durch
  82.         7PLUS korrigieren lassen. Wurde TEST.COR ebenfalls durch den S&F
  83.         zerstört, so muss man die TEST.COR erneut übertragen.
  84.  
  85.         Nach der Korrektur kann er TEST.7PL erfolgreich dekodieren.
  86.  
  87.         Enthält TEST.7PL mehr Fehler als in TEST.COR abgedeckt, so braucht
  88.         man nur ein neues TEST.ERR erstellen lassen und die Prozedur zu
  89.         wiederholen. Das ist aber immer noch besser, als das gesamte File
  90.         neu zu übertragen.
  91.  
  92.         Zugegeben, das Ganze hört sich recht kompliziert an. Ist es aber
  93.         nicht. Es handelt sich bei dem beschriebenen Verfahren lediglich um
  94.         die drei grundlegenden Schritte:
  95.  
  96.         "Fehler erkennen",
  97.         "Korrektur anfordern" und
  98.         "Korrektur durchführen".
  99.  
  100.  
  101.         Hat man das Konzept erst einmal begriffen und erfolgreich Programme
  102.         ausgelesen, wird einem klar werden, dass das Ganze garnicht so
  103.         kompliziert ist.
  104.  
  105.  
  106.         Entwicklung von 7PLUS:
  107.         ======================
  108.  
  109.         7PLUS ist auf der Basis von SEVEN enstanden. Die Fehlerkorrektur-
  110.         möglichkeiten mussten allerdings mit Inkompatibilät zu SEVEN
  111.         erkauft werden. Das ist aber nicht weiter schmerzlich, da das
  112.         komplett neue Einspielen von durch den S&F zerstörten Files nun
  113.         endgültig der Vergangenheit angehört.
  114.         Da 7PLUS ohnehin inkompatibel zu SEVEN ist, konnte ich auch gleich
  115.         einen RADIX216-Algorithmus implementieren, der noch kompaktere
  116.         Files ermöglicht.
  117.         Zu Anfang gab es erbitterten Widerstand gegen 7PLUS, da behauptet
  118.         wurde, dass ein Kodierer, der Zeichen über 7Fh verwendet, mehr
  119.         Probleme schafft, als Nutzen bringt. Die rasante Verbreitung und
  120.         Etablierung von 7PLUS als DER Kodierer schlechthin, dürfte das
  121.         Gegenteil bewiesen haben. Inzwischen findet 7PLUS nicht nur in DL,
  122.         sondern in ganz Europa Verwendung. Selbst in Japan ist 7PLUS
  123.         bereits 'gesichtet' worden.
  124.         Ein wichtiger Aspekt ist auch, dass 7PLUS für die in Packet
  125.         gebräuchlichsten Systeme verfügbar ist: IBM_PC, ATARI_ST, AMIGA und
  126.         UNIX-Systeme.
  127.         7PLUS-Files sind selbst inklusive der zeilenweisen CRC (Cyclic
  128.         Redundancy Check, Prüfsumme) und Nummerierung um 5 - 7% kompakter
  129.         als SEVEN-Files und fast 30% kompakter als UUENCODE-Files.
  130.  
  131.         Bitte werft UNSEVEN nicht weg, da sich noch einiges an SEVEN-Files
  132.         in den Mailboxen befindet. Bei Neueinspielungen sollte auf jeden
  133.         Fall 7PLUS statt SEVEN verwendet werden!
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.                                       Seite - 2
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.         Wie funktioniert 7PLUS? (im Groben)
  150.         ===================================
  151.  
  152.         7PLUS benutzt für die Wandlung einen RADIX216-Algorithmus (SEVEN:
  153.         RADIX128). Hierbei werden 31 Datenbytes auf 32 ASCII-Bytes abge-
  154.         bildet. Man könnte diese Kodierung auch als 7-dreiviertel-Bit-
  155.         Kodierung bezeichnen, daher der Name 7PLUS.
  156.         Vorteil gegenüber des Algorithmus von SEVEN: nur 3,23% Codever-
  157.         grösserung. Dieser Faktor verschlechtert sich durch die notwendigen
  158.         Zeilentrenner, Kopf- und Fusszeilen auf ca. 11 bis 12%.
  159.         Nachteil: Die Verarbeitung ist aufwendiger und somit deutlich
  160.         langsamer als bei Kodierungen, die eine Potenz von 2 als Zahlen-
  161.         basis haben. Kodierungen wie RADIX64 (UUE), RADIX128 (SEVEN) lassen
  162.         sich durch simple Bitverschiebungen realisieren. Etwas das prak-
  163.         tisch alle Prozessortypen mit sehr hoher Geschwingigkeit erledigen
  164.         können.
  165.         RADIX216 basiert nicht auf einer Potenz von 2, daher sind zum
  166.         Kodieren und Dekodieren Divisionen und Multiplikationen erforder-
  167.         lich, was deutlich mehr Zeit verbraucht, als einfache Bitschiebe-
  168.         reien. Einige ältere Prozessoren bieten zudem keine direkten
  169.         Befehle für die Multiplikation und Division, so dass diese Opera-
  170.         tionen dort per Software nachgebildet werden, was die Sache weiter
  171.         verlangsamt. Zum Glück sind die heute gängigen Prozessoren (80X86,
  172.         680XX) allesamt mit allen Grundrechenarten ausgestattet. Daher
  173.         werden trotzdem akzeptable Geschwindigkeiten erreicht.
  174.  
  175.         Bei der RADIX216-Kodierung werden 31 Datenbits viermal durch 216
  176.         geteilt. Der  Modulo-216-Rest zwischen den Divisionen stellt dann
  177.         jeweils ein Zeichen des Kodes dar und kann Werte im Bereich 0 bis
  178.         215 annehmen - also 216 verschiedene Werte.
  179.         Diese Zeichen lassen sich so aber noch nicht für die Übertragung
  180.         via Mailbox verwenden, da im ASCII-Zeichensatz eine Reihe von
  181.         Zeichen für Steueraufgaben vorgesehen ist. Um diese Beschränkung zu
  182.         umgehen, wird jedem Grundzeichen ein neues Zeichen zugewiesen.
  183.  
  184.         Der dabei resultierende Zeichensatz enhält folgende Zeichen:
  185.  
  186.           21h - 29h, 2Bh- 7Eh, 80h - 90h, 92h, 94h - FCh
  187.           (jeweils einschliesslich)
  188.  
  189.         Die Lücken im Zeichensatz sind Absicht.
  190.  
  191.         Ausgelassene Zeichen:
  192.  
  193.         00h bis 20h: Steuerzeichen und das Space.
  194.  
  195.         2Ah        : Stern, per Zufall könnte sonst des String '*** end'
  196.                      entstehen, und das Einspielen bei DieBox-Mailboxen
  197.                      unmöglich machen.
  198.  
  199.         7Fh        : DEL, ein Steuerzeichen.
  200.  
  201.         91h und 93h: Manche Telefonterminalprogramme interpretieren diese
  202.                      Zeichen fälschlicherweise als XON und XOFF (11h und
  203.                      13h), obwohl alle anderen Zeichen korrekt mitgeschrie-
  204.                      ben werden.
  205.  
  206.         Es vesteht sich von selbst, dass man diese Zeichen auch gespei-
  207.         chert bekommen muss! (Tips im Anhang)
  208.  
  209.  
  210.  
  211.  
  212.  
  213.                                       Seite - 3
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.         Wie sind 7PLUS-Files aufgebaut?
  222.         ===============================
  223.  
  224.         7PLUS-Files bestehen grundsätzlich aus einem Header, Daten und
  225.         einem Abschluss. Jede Zeile ist mit einer CR/LF-Kombination als
  226.         Zeilentrenner abgeschlossen (MSDOS und ATARI. Zeilentrenner bei
  227.         AMIGA/UNIX ist LF).
  228.         Während der Übertragung per Packet Radio ist der Zeilentrenner nur
  229.         CR. Die Wandlung CR/LF (LF bei AMIGA/UNIX) in CR und retour
  230.         übernehmen die Terminalprogramme selbsttätig.
  231.         Ausnahme: Mitschreiben oder Aussenden im Binärmodus mancher Termi-
  232.         nalprogramme.
  233.         Siehe Anhang 'Tips'.
  234.  
  235.  
  236.         Der Header:
  237.         -----------
  238.  
  239.          go_7+. 005 of 010 TEST.TXT     0010453 6488 166 (7PLUS v1.5) XXXXY
  240.         +-----+ +-+    +-+ +----------+ +-----+ +--+ +-+ +----------+ +---+
  241.            1     2      3       4          5      6   7       8         9
  242.  
  243.           1) Startkennung, beginnend in der zweiten Spalte
  244.           2) Teil 5
  245.           3) von 10 Teilen
  246.           4) Filename der kodierten Datei, auf 12 Zeichen mit Spaces
  247.              aufgefüllt. Bei Systemen, die grössere Filenamen zulassen,
  248.              wird hier auf trotzdem ein MS_DOS-kompatibler Filename
  249.              geliefert!
  250.           5) Filelänge der kodierten Datei.
  251.           6) Anzahl ASCII-Bytes in diesem Teil (HEX)
  252.           7) Blockgrösse in Zeilen (HEX)
  253.           8) Wandlername und Version
  254.           9) XXXX: Prüfzeichen, um Zeichensatzunverträglichkeiten zu er-
  255.              kennen. Dient ebenfalls zur Kennzeichnung, dass in der
  256.              nächsten Zeile der volle, systemspezifische Filename mitge-
  257.              liefert mit (ab 7PLUS 1.4; nur AMIGA/UNIX-Versionen). Damit
  258.              ist gewährleistet, dass 7PLUS-Files, die auf Systemen mit
  259.              nicht-MS_DOS-kompatiblen Filenamen erstellt wurden, trotzdem
  260.              austauschbar sind.
  261.              Y: Miniprüfsumme für den Header (ab 7PLUS v1.5).
  262.  
  263.  
  264.         Die Daten:
  265.         ----------
  266.  
  267.         AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBPPP
  268.         +--------------------------------------------------------------++-+
  269.                      64 ASCII-Bytes, entspricht 62 Datenbytes            *
  270.  
  271.            A: erste Gruppe (32 ASCII-Bytes, die 31 Datenbytes darstellen).
  272.            B: zweite Gruppe.
  273.            P: Prüfsumme und Zeilennummer.
  274.  
  275.  
  276.            Jede Datenzeile besteht aus 64 ASCII-Bytes plus 3 Bytes (*), die
  277.            die Zeilennummerierung und Prüfsumme darstellen und dem Zeilen-
  278.            trenner.
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.                                       Seite - 4
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.            Die drei Bytes am Ende einer Zeile setzen sich aus einer 14Bit
  294.            CRC und einer 9Bit Zeilennummer zusammen. (Berechnung der CRC:
  295.            siehe 7PLUS.C)
  296.  
  297.            Jedes 7PLUS-File enthält maximal 512 Datenzeilen. Reicht das
  298.            nicht, so wird gesplittet.
  299.  
  300.            Pro Teil lassen sich also 512 * 62 Bytes übertragen, ergibt
  301.            31744 Bytes. Insgesamt lassen sich also bei 255 möglichen Teilen
  302.            255 * 31744 Bytes Übertragen, entspricht 8.094.720 Bytes. Das
  303.            sollte reichen, hi.
  304.  
  305.  
  306.         Der Abschluss:
  307.         --------------
  308.  
  309.           stop_7+. (TEST.P05)
  310.          +-------+ +--------+
  311.             1          2
  312.  
  313.            1) Abschlusskennung, beginnend in der zweiten Spalte.
  314.            2) Name dieses Teils.
  315.  
  316.  
  317.         Das Fehlerprotokoll:
  318.         ====================
  319.  
  320.            Wurden 7PLUS-Files bei der Übertragung beschädigt, so erkennt
  321.            7PLUS die Fehler beim Dekodieren und erstellt ein Fehlerproto-
  322.            koll in dem alle Informationen enthalten sind, die zur Erstel-
  323.            lung einer passenden Korrekturdatei erforderlich sind.
  324.  
  325.            Ein Fehlerprotokoll sieht wie folgt aus:
  326.  
  327.             go_text. TEST.ERR
  328.            7PLUS error report: TEST.TXT 113 /Test.TXT/ 34028
  329.            01
  330.            005 006 007 03D FFF
  331.            02
  332.            10C 10D 10E FFF
  333.            00
  334.            CRC A17D
  335.             stop_text.
  336.  
  337.            Die Zeilen 'go_text.' und 'stop_text.' dienen dazu, das Fehler-
  338.            protokoll aus einer Mitschrift zu extrahieren.
  339.            Die Kopfzeile '7PLUS error report...' enthält Informationen wie:
  340.  
  341.            Name der Originaldatei,
  342.            Blockgrösse, in die beim Kodieren gesplittet wurde,
  343.            der volle systemspezifische Dateiname (nur AMIGA/UNIX)
  344.            und (ab 7PLUS v1.5) die Dateilänge der Originaldatei.
  345.  
  346.            Die zweistelligen Hexadezimalwerte geben an, in welchem Teil der
  347.            7PLUS-Files die nachfolgenden Zeilen beim Dekodieren bemängelt
  348.            wurden. Die Zeilenangabe 'FFF' dient als Kennung, dass die Liste
  349.            der Fehlerstellen für den angegebenen Teil beendet ist.
  350.            Die Angabe '00' für den Teil schliesst das Fehlerprotokoll ab.
  351.            Ab 7PLUS v1.5 folgt dann noch eine Prüsumme, die dazu dient, die
  352.            Angaben in dem Fehlerprotokoll zusätzlich zu sichern.
  353.  
  354.  
  355.  
  356.  
  357.                                       Seite - 5
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.         Die Korrekturdatei:
  366.         ===================
  367.  
  368.            Hat man das Fehlerprotokoll an den Einspieler geschickt, so
  369.            erstellt dieser damit eine Korrekturdatei, die die im Fehler-
  370.            protokoll bemängelten Zeilen enthält. Die Korrekturdatei schickt
  371.            er dann retour oder spielt sie allgemein zugänglich in die Mail-
  372.            box ein, wenn er feststellt, dass die meisten Fehlerprotokolle
  373.            die gleichen Fehlerstellen aufweisen. In diesem Fall bietet sich
  374.            für ihn noch zusätzlich die Möglichkeit an, unterschiedliche
  375.            Fehlerprotokolle mit der '-J'-Option zu einem Gesamt-Fehler-
  376.            protokoll zusammenzufassen und daraus eine entsprechende
  377.            Korrekturdatei zu erstellen.
  378.  
  379.            Beispiel einer Korrekturdatei:
  380.            (Inhalte der Datenzeilen gekürzt dargestellt)
  381.  
  382.             go_text. TEST.COR
  383.            7PLUS correction: TEST.TXT 34028
  384.             P01:
  385.             L005:
  386.            sdWKLRjwEK...
  387.             L006:
  388.            "rt4rWER7Z...
  389.             L007:
  390.            eeERG35ERG...
  391.             L03D:
  392.            $%&H$%6TZJ...
  393.             P02:
  394.             L10C:
  395.            AdD$%SFFDr...
  396.             L10D:
  397.            sFG$sFw4rf...
  398.             L10E:
  399.            56fZTddfDg...
  400.             P00:
  401.            CRC A9B6
  402.             stop_text.
  403.  
  404.            'go_text.', 'stop_text.' und Prüfsumme: siehe 'Das Fehlerproto-
  405.            koll'.
  406.  
  407.            Die Kopfzeile '7PLUS correction...' enthält folgende
  408.            Informationen:
  409.  
  410.            Name der Originaldatei
  411.            und (ab 7PLUS v1.5) die Länge der Originaldatei.
  412.  
  413.            Eine Zeile mit einem Eintrag der Form ' PXX:' gibt an, für
  414.            welchen Teil der kodierten Teile die nachfolgenden Zeilen
  415.            bestimmt sind. Den einzelnen Zeilen sind Einträge der Form
  416.            ' LXXX:' vorrangestellt. 'XX' und 'XXX' stehen hierbei für zwei-
  417.            beziehungsweise dreistellige Hexadezimalzahlen.
  418.  
  419.            Die Struktur der Fehlerprotokolle und Korrekturdateien ist
  420.            bewusst möglichst simpel ausgelegt.
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.                                       Seite - 6
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.         Kompatibilität der 7PLUS-Versionen untereinander:
  438.         =================================================
  439.  
  440.         Die Files aller älteren 7PLUS-Versionen lassen sich mit allen
  441.         Versionen dekodieren, d.h. ein File, das mit 7PLUS v1.0 kodiert
  442.         wurde, lässt sich problemlos mit 7PLUS v1.5 dekodieren, und um-
  443.         gekehrt.
  444.  
  445.         Ebenso sind die Fehlerprotokolle und Korrekturdateien der einzelnen
  446.         7PLUS-Versionen untereinander kompatibel.
  447.  
  448.         Ab 7PLUS v1.5 sind die Fehlerprotokolle und Korrekturdateien mit
  449.         einer zusätzlichen Prüfsumme versehen. Diese wird nur bei Vorhan-
  450.         densein auf Korrektheit überprüft. Wird keine Prüfsumme gefunden,
  451.         warnt 7PLUS mit der Meldung 'no CRC. File may be corrupted or from
  452.         version earlier than 7PLUS v1.5'. Dies bedeutet lediglich, das die
  453.         100% Korrektheit des Fehlerprotokolls oder der Korrekturdatei man-
  454.         gels Prüfsumme nicht ermittelt werden konnte. Zumindest sollte man
  455.         sich dann per Augenschein davon überzeugen, dass die betreffende
  456.         Datei nicht krasse Fehler enthält.
  457.  
  458.         Immer wieder geschieht es, dass mein alter Kodierer SEVEN mit 7PLUS
  459.         verwechselt wird. Um es deutlich zu sagen: SEVEN und 7PLUS sind
  460.         unterschiedliche Kodierer; sie verwenden unterschiedliche Kodier-
  461.         verfahren und sind nicht untereinander kompatibel! Das einzige, was
  462.         die beiden Kodierer gemeinsam haben, ist die Tatsache, dass sie aus
  463.         der selben Feder stammen.
  464.  
  465.         Da 7PLUS gegenüber SEVEN ganz erhebliche Vorteile bietet, ist von
  466.         der Verwendung von SEVEN für die Einspielung in Mailboxen GENERELL
  467.         abzusehen!!!
  468.  
  469.  
  470.         Filenamen-Konvention:
  471.         =====================
  472.  
  473.         Filenamen, die 7PLUS verarbeitet, müssen den Regeln der Namens-
  474.         bildung unter MS_DOS entsprechen, egal auf welchem System 7PLUS
  475.         implementiert ist. Sie bestehen immer aus einem bis zu 8 Zeichen
  476.         langen Namen plus einer bis zu drei Zeichen umfassenden Endung
  477.         (Extension). Name und Endung sind durch einen Punkt getrennt. Für
  478.         die Darstellung der Namen in 7PLUS-Files wird immer Grossschrift
  479.         verwendet. Liegen 7PLUS-Files auf Disk vor, so werden die Namen
  480.         kleingeschrieben, wenn es das System zulässt. Wichtig ist dieser
  481.         Punkt bei Systemen, die zwischen Gross- und kleinschrift bei
  482.         Filenamen unterscheiden, z.B. das UNIX-Filesystem.
  483.         Beispiel eine Filenamens nach obigen Regeln (auf einem MS_DOS-
  484.         System): TERMINAL.EXE
  485.  
  486.         Um bei Systemen mit nicht-MS_DOS-kompatiblen Filenamen die Über-
  487.         tragung des vollen Namens zu ermöglichen, wird dieser gesondert
  488.         übermittelt. Gleichzeitig wird ein MS_DOS-kompatibler Filename
  489.         erzeugt.
  490.         Zum Beispiel wird aus dem Filenamen 'Hyper_Term_Plus' der Name
  491.         'HYPER_TE'
  492.  
  493.         Wird ein File 7PLUS-kodiert ohne zu splitten, bekommt die kodierte
  494.         Datei die Endung '.7pl'. Beispiel: TERMINAL.7PL
  495.  
  496.         Bei gesplitteten Dateien ist die Endung '.pXX', wobei XX für eine
  497.         hexadezimale Zahl im Bereich 01 bis FF steht.
  498.  
  499.  
  500.  
  501.                                       Seite - 7
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.         Fehlerprotokolle haben im Normalfall  die Endung '.err' und Kor-
  511.         rekturdateien immer die Endung '.cor'! Dies ist besonders wichtig,
  512.         da 7PLUS über die Endung erkennt, welche Aktion durchgeführt werden
  513.         soll (Korrekturfile erzeugen oder Korrektur durchführen). Bei
  514.         Fehlerprotokollen und Korrekturfiles ist es durchaus zulässig,
  515.         einen anderen Namen zu wählen, lediglich die Endung MUSS '.err'
  516.         oder '.cor' lauten!
  517.         Hat man auf eine Einspielung hin viele Fehlerprotokolle erhalten,
  518.         gibt es noch eine weitere Möglichkeit der Namesgebung für Fehler-
  519.         protokolle. Das erste Fehlerprotokoll trägt dann wie gehabt die
  520.         Endung '.err' und die folgenden die Endung '.eXX', wobei XX für
  521.         eine zweistellige Hexadezimalzahl steht.
  522.         Beispiel: Man hat drei Fehlerprotokolle erhalten, die sich auf die
  523.         selbe Einspielung (TEST.7PL) beziehen. Beim Extrahieren über die
  524.         '-X'-Option entstehen dann die Files TEST.ERR, TEST.E01 und
  525.         TEST.E02. Die drei Fehlerprotokolle können dann automatisch mit
  526.         Hilfe der '-J'-Option zusammengefügt werden.
  527.  
  528.         7PLUS-Files sollten immer unter dem diesen Vorschriften entsprech-
  529.         enden Namen gespeichert werden. Dies ist besonders im Bezug aus die
  530.         Korrektur und gesplittete Files wichtig.
  531.         Am Ende jedes 7PLUS-Files ist der Name angegeben, unter dem es ge-
  532.         speichert werden muss.
  533.  
  534.         Wie benutze ich 7PLUS?
  535.         ======================
  536.  
  537.  
  538.         Kodieren:
  539.         ---------
  540.  
  541.         7plus test.txt
  542.            test.txt wird kodiert. Umfasst das resultierende File mehr als
  543.            512 Datenzeilen, so wird automatisch in 512-Zeilen pro File
  544.            gesplittet.
  545.  
  546.         7plus test.txt -s
  547.            Kodieren und splitten, 140 Zeilen pro File (entspricht ca. 10k).
  548.  
  549.         7plus test.txt -s 30
  550.            30 Zeilen pro File.
  551.  
  552.  
  553.         7plus test.txt -sp 3
  554.            Kodieren und in 3 möglichst gleich grosse Teile splitten.
  555.  
  556.  
  557.         Dekodieren:
  558.         -----------
  559.  
  560.         7plus test.7pl
  561.            'test.7pl' wird dekodiert. Das Fehler-protokoll test.err wird
  562.            erzeugt, wenn Fehler gefunden werden.
  563.  
  564.  
  565.         7plus test.p01
  566.            Zusammenfügen und dekodieren, sonst wie vorheriges Beispiel.
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.                                       Seite - 8
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.         7plus test
  582.            Beim Dekodieren kann die Extension (Endung) auch weggelassen
  583.            werden. Findet 7PLUS test.cor, so wird zuerst die Korrektur
  584.            durchgeführt und dann dekodiert.
  585.            Existiert jedoch ein File mit dem Namen 'test', so wird es
  586.            kodiert!
  587.  
  588.  
  589.         Korrektur:
  590.         ----------
  591.  
  592.         7plus test.err c:\pr\
  593.            Korrekturfile test.cor erzeugen. test.txt wird in 'c:\pr\' ge-
  594.            sucht. test.txt ist dabei das File, das ursprünglich kodiert
  595.            wurde. Ein Aufbewahren der kodierten Files ist also nicht
  596.            unbedingt notwendig. Dafür sollte man tunlichst test.txt aufbe-
  597.            wahren, da man sonst keine Korrekturfiles erzeugen kann!
  598.            Eine spezielle Situation kann sich ergeben, wenn ein 7PLUS-File
  599.            auf einem System mit nicht-MS_DOS-kompatiblen Filenamen erzeugt
  600.            wurde.
  601.            Beispiel:
  602.            Ein OM kodiert 'Hyper_Term_Plus' auf einem AMIGA. 7PLUS erzeugt
  603.            aus dem AMIGA-Filenamen den MS_DOS-kompatiblen Filemamen
  604.            'HYPER_TE' (Der volle AMIGA-Filename wird ebenfalls übermittelt,
  605.            wird jedoch auf MS_DOS und ATARI_ST ignoriert). Dekodiert nun
  606.            ein MS_DOS-Benutzer das 7PLUS-File mit einer älteren Version von
  607.            7PLUS (vor v1.4), wird im Falle von Übertragungsfehlern das
  608.            Fehlerprotokoll 'HYPER_TE.ERR' erzeugt, jedoch wird es den
  609.            MS_DOS-kompatiblen Filenamen enthalten. Schickt er das Fehler-
  610.            protokoll an den AMIGA-Benutzer, so wird 7PLUS auf dem AMIGA
  611.            versuchen das Originalfile 'Hyper_Term_Plus' unter dem Namen
  612.            'HYPER_TE' zu suchen und logischerweise nicht finden. In diesem
  613.            Fall kann der volle Pfad inklusive des Filenamen des Original-
  614.            files angegeben werden:
  615.            z.B.: 7plus hyper_te.err df0:utils/Hyper_Term_Plus
  616.            Wurde 7PLUS 1.4 (oder höher) benutzt, tritt dieses Problem NICHT
  617.            auf, da in jedem Fall neben dem MS_DOS-kompatiblen Filename auch
  618.            der volle Originalname im .err-File übermittelt wird - auch wenn
  619.            dieser ansonsten nicht ausgewertet wird.
  620.  
  621.         7plus test.cor
  622.            test.7pl/test.pXX mit Hilfe des Korrekturfiles reparieren. Wird
  623.            anschliessend versucht zu dekodieren, so wird unter Umständen
  624.            erneut ein Fehlerprotokoll erstellt. Das ist dann der Fall, wenn
  625.            nicht alle Fehlerstellen im Korrekturfile abgedeckt sind. Das
  626.            neue Fehlerprotokoll ist dann an den Absender des .cor-Files
  627.            einzusenden, um die zusätzliche Korrektur anzufordern.
  628.  
  629.         7plus test.err test2.err -j
  630.            Der Inhalt des Fehlerprotokolls test2.err wird zum Inhalt des
  631.            ersten Fehlerprotokolls hinzugefügt. Dies ist dann nützlich,
  632.            wenn man meherere verschiedene Fehlerprotokolle erhalten hat,
  633.            deren Summe an Fehlerstellen aber nicht so gross ist. Dann kann
  634.            man ein Sammel-Protokoll erstellen und daraus ein Gesamtkorrek-
  635.            turfile.
  636.  
  637.  
  638.         7plus test.err -j
  639.            Dies ist eine Sonderform des Zusammenfügens von Fehlerproto-
  640.            kollen, bei der mehrere Fehlerprotokolle automatisch zusammen-
  641.            gefügt werden. Hierzu müssen die Fehlerprotokolle per '-X'-
  642.  
  643.  
  644.  
  645.                                       Seite - 9
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.            Option aus einer Mailboxmitschrift extrahiert werden. Dabei
  654.            benennt 7PLUS das erste Fehlerprotokoll wie gewohnt. Alle
  655.            folgenden Fehlerprotokolle, werden dann mit einer anderen Endung
  656.            abgelegt, z.B. TEST.E01, TEST.E02 usw.
  657.            Bei obigem Aufruf von 7PLUS werden dann alle Fehlerprotokolle
  658.            zusammengefügt. TEST.ERR stellt dann die Summe aller Fehler-
  659.            protokolle dar.
  660.  
  661.  
  662.         7PLUS-Files extrahieren:
  663.         ------------------------
  664.  
  665.         7plus savefile text -x
  666.            'Schneidet' alle 7PLUS-Files aus 'savefile' aus und speichert
  667.            sie getrennt ab. Wird 'text' angegeben, so werden nur die Files
  668.            extrahiert, die 'text' in ihrem Namen enhalten.
  669.  
  670.            Beispiel: 7plus spsave.c10 952.err -x
  671.                      Extrahiert alle Fehlerprotokolle aus spsave.c10, deren
  672.                      Filename '952.err' enthält.
  673.  
  674.            Gibt man einen fiktiven Suchbegriff (z.B. '###') an, so erhält
  675.            man eine Liste der in 'savefile' enthaltenen 7PLUS-Files.
  676.  
  677.            Beim Extrahieren ist es egal, in welcher Form die Zeilentrenner
  678.            in 'savefile' vorliegen: CR/LF, CR oder LF. Die extrahierten
  679.            Files haben jedoch immer einen dem System entsprechenden Zeilen-
  680.            trenner: CR/LF beim PC und ATARI, LF beim AMIGA/UNIX. Auf diese
  681.            Weise wird kein Editor für das Zerteilen des Savefiles benötigt
  682.            und die korrekte Namensgebung der einzelnen Teile ist gewähr-
  683.            leistet (dies ist besonders wichtig bei mehrteiligen 7PLUS-
  684.            Files). Ebenfalls extrahiert werden 7PLUS-Fehlerprotokolle und
  685.            -Korrekturfiles. Dies funktioniert jedoch nur, wenn die Markie-
  686.            rungen (go_text., stop_text.) vorhanden sind!
  687.  
  688.         Weitere Optionen:
  689.         -----------------
  690.  
  691.         -N (nur ATARI_ST-Version) Normalerweise wartet 7PLUS nach Beendi-
  692.            gung auf einen Tastendruck. Durch diese Option kann diese
  693.            Abfrage abgeschaltet werden. Dies ist dann nützlich, wenn 7PLUS
  694.            von anderen Programmen (Shell) aufgerufen wurde.
  695.  
  696.         -P Kodierte Files, Fehlerprotokolle und Korrekturfiles werden mit
  697.            CR als Zeilentrenner geschrieben. Dies ist zum Beispiel bei Ter-
  698.            minalprogrammen erforderlich, bei denen 7PLUS-Files im Binär-
  699.            modus gesendet werden müssen, da im Textmodus nicht alle Zeichen
  700.            korrekt verarbeitet werden. Besonders wichtig ist dies auf dem
  701.            AMIGA, da dieser standardmässig LF als Zeilentrenner benutzt. LF
  702.            wird in Packet Radio nicht verwendet, sondern nur CR. Würde man
  703.            ein 7PLUS-File, dass nicht mit der -P Option erstellt wurde,
  704.            binär senden, so würde auf der Gegenseite (Mailbox) nichts
  705.            Brauchbares ankommen, da dort in der Regel alle empfangenen LF
  706.            entfernt werden! Das Resultat wäre eine Datei, die eine einzige,
  707.            fürchterlich lange Zeile enthält!
  708.  
  709.         -T Mit dieser Option kann ein Text angegeben werden, der bei ko-
  710.            dierten Files, Fehlerprotokollen und Korrekturfiles angehängt
  711.            werden soll, um der Mailbox beim Einspeilen zu signalisieren,
  712.            dass das File zuende ist.
  713.            Beispiel: 7plus test.txt -sp 2 -p -t *** end
  714.  
  715.  
  716.  
  717.                                      Seite - 10
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.            (Das Leerzeichen zwischen den drei Sternen und dem end ist nicht
  726.            einzugeben. Es dient nur dazu, zu verhindern, dass beim Einspie-
  727.            len dieses Textes mittendrin schluss ist.)
  728.            Hinweis: Beginnt der angegebene Text mit einem Minuszeichen, so
  729.            muss der Text in Anführungsstriche eingefasst werden! Andern-
  730.            falls würde er nicht als Text übernommen, sondern 7PLUS würde
  731.            versuchen ihn als Option zu interpretieren.
  732.  
  733.         -Y Bei allen Fragen gibt 7PLUS automatisch die Antwort 'Y' vor.
  734.            Diese Option ist dann nützlich, wenn 7PLUS von anderen
  735.            Programmen aufgerufen wurde (Shell, Server).
  736.  
  737.         -# Bei Anwendung von 7PLUS in einem File-Server ergibt sich das
  738.            Problem, dass der Server umständlich feststellen muss, wieviele
  739.            Teile beim Kodieren erstellt wurden. Dies ist besonders dann der
  740.            Fall, wenn über die '-S'-Option kodiert wurde, da dort die
  741.            Anzahl der erzeugten Teile nicht ohne weiteres vorrauszusehen
  742.            ist (wer sich mit C auskennt, findet in 7PLUS aber trotzdem
  743.            entsprechende Berechnungen, bei denen sich die Anzahl Teile
  744.            dennoch vorrausberechnen lässt). Bei Verwendung der '-#'-Option
  745.            wird nach dem Kodieren ein File namens 7PLUS.FLS erzeugt, das
  746.            die Anzahl (dezimal) der erzeugten Teile und den MS_DOS-kompa-
  747.            tiblen Filenamen der Teile enthält, z.B.: 10 TEST
  748.  
  749.  
  750.         Eine kurze Syntaxhilfe mit Beispielen lässt sich durch den Para-
  751.         meter '-h' abfragen (oder man ruft 7PLUS ohne Parameter auf).
  752.  
  753.  
  754.  
  755.         Tips:
  756.         =====
  757.  
  758.         Um 7PLUS-Files verarbeiten zu können, ist es wichtig, dass der
  759.         eigene TNC und das Terminal korrekt parametriert sind.
  760.         Bei TNC2 mit TAPR-Firmware, KAM, PK232 muss 8BITCONV ON, AWLEN 8
  761.         und LCOK ON - oder gleichwertige Befehle entsprechend - eingestellt
  762.         sein. Die serielle Verbindung zum TNC sollte auf 8 Bits, 1 Stopbit,
  763.         keine Parität eingestellt sein (8n1).
  764.         Es empfiehlt sich, das Streamswitchzeichen auf $01 (CTRL-A) einzu-
  765.         stellen, da alle sonstigen darstellbaren Zeichen von 7PLUS verwen-
  766.         det werden.
  767.         Ist der Streamswitch auf $7C (|) eingestellt, kann es beim Einspie-
  768.         len von 7PLUS-Files zu unerwünschten Kanalwecheln kommen! Ebenfalls
  769.         kann dadurch das Terminalprogramm beim Empfang von 7PLUS-Files
  770.         fälschlicherweise Streamswitchzeichen erkennen und unvorhersehbare
  771.         Aktionen ausführen.
  772.  
  773.         Entgegen einiger Gerüchte ist der PK232 uneingeschränkt 8Bit-fähig!
  774.  
  775.         Umkodierungstabellen von Telefon-Terminalprogrammen müssen auf 1:1
  776.         Wandlung eingestellt werden. Manche Terminalprogramme habe Optionen
  777.         wie 'high bit on/off'. Diese Optionen MÜSSEN so eingestellt werden,
  778.         dass das höchste Bit (Bit 8) nicht unterdrückt wird! Probleme
  779.         können sog. Terminalemulationen (VT100, ANSI usw) bereiten. Meist
  780.         bieten die Terminalprogramme dann auch den Typ TTY an, dieser
  781.         sollte gewählt werden. Hierzu muss bemerkt werden, dass alle
  782.         Steuersequenzen dieser Emulationen in der Regel mit einem ESCAPE
  783.         (1Bh) beginnen - ein Zeichen, das von 7PLUS nicht verwendet wird,
  784.         daher sollte es keine Probleme geben.
  785.  
  786.  
  787.  
  788.  
  789.                                      Seite - 11
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.         Wenn man dann 7PLUS-Files immer noch nicht verarbeiten kann, so
  798.         liegt das Problem bei der verwendeten Terminalsoftware. In diesem
  799.         Fall könnten die Tips zu SUPERKISS und THP sinngemäss zutreffen.
  800.         Hilft das auch nicht, so sollte man sich an den Autor des Terminal-
  801.         programms wenden. Er wird in seinem eigenen Interesse dafür sorgen,
  802.         dass seine Terminalsoftware an die heutigen Gegebenheiten von
  803.         Packet Radio angepasst wird. Bei kommerziellen Telefon-Terminal-
  804.         programmen wird das wohl nicht gehen.
  805.  
  806.         Allgemein kann man aber raten, keine für Telefon-Betrieb gedachten
  807.         Terminalprogramme für Packet Radio zu verwenden. Es gibt hervor-
  808.         ragende Terminalprogramme, die speziell für Packet Radio ausgelegt
  809.         sind. Sie kosten in der Regel nicht einmal etwas....
  810.  
  811.         Es wird nicht lange dauern, bis alle für Packet Radio gedachten
  812.         Terminalprogramme mit 8Bit-Zeichen klarkommen, entsprechenden Druck
  813.         auf die Autoren vorrausgesetzt.
  814.  
  815.  
  816.         TheFirmware- oder WA8DED-Eprom:
  817.         -------------------------------
  818.  
  819.         Ist im Terminalmodus nicht unbedingt 8-Bit-fähig. (Ausnahme:
  820.         TheFirmware v2.2a DAMA und folgende) Da der Terminalmodus der
  821.         Firmware aber nur für den Notbetrieb gedacht ist, stellt das kein
  822.         Problem dar. Ihre eigentliche Leistungsfähigkeit entfaltet sie erst
  823.         im Hostmodus, wofür sie auch primär gedacht ist. Wer TheFirmware
  824.         nur im Terminalmodus betreibt, wirft Perlen vor die Säue, hi.
  825.  
  826.  
  827.         Umlautwandlungen:
  828.         -----------------
  829.  
  830.         Jegliche Umlautwandlungen sind beim Auslesen oder Einspielen von
  831.         7PLUS-Files auszuschalten! WICHTIG!!!!!
  832.                                    ------------
  833.  
  834.  
  835.         THP (Versionen ab v2.8):
  836.         ------------------------
  837.  
  838.         Das Mitschreiben von 8Bit-Zeichen kann durch Drücken von ALT-U (bis
  839.         U8 in der Statuszeile erscheint) zugelassen werden.
  840.  
  841.  
  842.         THP (Versionen kleiner v2.8) und SUPERKISS/PRKISS/BAYCOM:
  843.         ---------------------------------------------------------
  844.  
  845.         Bei diesen Programmen ist es notwendig 7PLUS-Files im Binärmodus
  846.         mitzuschreiben.
  847.  
  848.         Dies liegt daran, dass bei diesen Programmen beim Mitschreiben
  849.         generell Bit 8 abgeschnitten wird, was dazu führt, dass 7PLUS-Files
  850.         mit diesen Programmen Probleme bereiten.
  851.  
  852.         Es gibt aber eine Lösung:   Mitschreiben im Binärmodus.
  853.  
  854.         SUPERKISS/PRKISS/BAYCOM/: Binäres Mitschreiben ist mit WPRG
  855.                                   möglich.
  856.         THP      : CTRL-E und dann die Frage nach dem Modus mit B für Binär
  857.                    beantworten.
  858.  
  859.  
  860.  
  861.                                      Seite - 12
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.         Nun gibt es noch ein Problem: Es wird wirklich 1:1 mitgeschrieben.
  871.  
  872.         Warum das ein Problem ist?
  873.  
  874.         Ganz einfach:
  875.  
  876.         In Packet Radio wird CR (0Dh) als Zeilentrenner benutzt. PCs
  877.         erwarten bei der Verarbeitung von Texten jedoch die Kombination
  878.         CR+LF (0Dh 0Ah). Durch das binäre Mitschreiben wurden die Packet-
  879.         CRs nicht in CR+LF gewandelt. Lädt man so eine Datei in einen
  880.         Editor, so wird dieser in der Regel eine zu lange Zeile melden, da
  881.         er auf jeden Fall ein CR+LF als Zeilentrenner erwartet. Ein CR
  882.         alleine wird einfach nur als irgendein Zeichen betrachtet.
  883.  
  884.         Aber auch hierfür gibt es eine Lösung: CRLF.EXE (gibt's in der
  885.         Mailbox oder auf Wunsch bei mir direkt, jedoch nur für IBM).
  886.  
  887.         Dieses kleine Hilfsprogramm wandelt CRs in CR+LFs und umgekehrt.
  888.  
  889.         Die damit behandelten, im Binärmodus mitgeschriebenen, 7PLUS-Files
  890.         können dann Problemlos verarbeitet und decodiert werden.
  891.  
  892.         Das Mitschreiben im Binärmodus hat noch einen angenehmen Neben-
  893.         effekt:
  894.  
  895.         Nationale Umlaute (französisch, spanisch usw) sowie Rahmenzeichen
  896.         können korrekt mitgeschrieben werden. Das ist im Textmodus dieser
  897.         Programme NICHT möglich.
  898.         Man braucht nur anschliessend CRLF.EXE auf die Mitschrift anzu-
  899.         wenden, und kann dann die Mitschrift ganz normal weiterverarbeiten.
  900.  
  901.         Eine andere Möglichkeit ist bereits in 7PLUS integriert:
  902.         Die '-X'-Option. Damit lassen sich 7PLUS-Files korrekt aus einer
  903.         Mitschrift extrahieren, selbst wenn der Zeilentrenner nicht CR/LF
  904.         ist, sondern CR oder LF.
  905.  
  906.         Vorgehensweise zum korrekten Auslesen von 7PLUS-files mit THP/
  907.         SUPERKISS/PRKISS/BAYCOM:
  908.  
  909.         File im Binärmodus mitschreiben (SUPERKKISS/PRKISS/BAYCOM: WPRG,
  910.         THP: CTRL-E B).
  911.         CRLF auf die Mitschrift ansetzen oder 7PLUS files über die '-X'-
  912.         Option von 7PLUS 'zerlegen' lassen (das Editieren oder die Anwend-
  913.         ung von FFR erübrigen sich dann).
  914.  
  915.         Mit einem Editor die 7PLUS-Files extrahieren, oder wenn vorhanden
  916.         mit FFR.
  917.         Die entstandenen 7PLUS-files dekodieren... Fertig.
  918.  
  919.  
  920.         7PLUS auf dem AMIGA:
  921.         --------------------
  922.  
  923.         Die meisten Terminalprogramme, die es derzeit für den AMIGA gibt,
  924.         sind in der Regel nicht in der Lage, 7PLUS-Files im Textmodus
  925.         korrekt mitzuschreiben (Es gibt auch lobenswerte Ausnahmen, wie ich
  926.         hörte). Dies liegt daran, dass die meisten Terminalprogramm die
  927.         'oberen' Steuerzeichen des AMIGA (80h bis 9Fh) leider als solche
  928.         interpretieren, statt sie auf dem Bildschirm durch 'unverfängliche'
  929.         Ersatzzeichen darzustellen. Terminalprogramme, die die 'oberen'
  930.  
  931.  
  932.  
  933.                                      Seite - 13
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.         Steuerzeichen nicht interpretieren, führen dafür meist Umlaut-
  942.         wandlungen durch, was tödlich für 7PLUS-Files ist.
  943.         Da sich 7PLUS beim PC und ATARI schon recht gut durchgesetzt hat,
  944.         werden die Autoren der AMIGA-Terminals nicht umhinkommen, sich mit
  945.         diesem Problem zu befassen, des Datenaustauschs zwischen den ver-
  946.         schiedenen Systemen zuliebe.
  947.  
  948.         Jedoch schafft auch hier das Mitschreiben im Binärmodus Abhilfe.
  949.         Damit die Files jedoch dekodierbar sind, müssen sie über die '-X'-
  950.         Option von 7PLUS aus der Mitschrift extrahiert werden. Editieren
  951.         der Files ist dann nicht notwendig.
  952.  
  953.         Beim Einspielen von 7PLUS-Files mit dem AMIGA im Binärmodus ist zu
  954.         beachten, dass der beim AMIGA übliche Zeilentrenner (LF) unbedingt
  955.         in den für Packet notwendigen Zeilentrenner (CR) umgesetzt wird.
  956.         Hierfür gibt es die '-P'-Option von 7PLUS.
  957.  
  958.  
  959.         Tips zum Auslesen von 7PLUS-kodierten Programmen/Bildern usw. aus
  960.         =================================================================
  961.         Mailboxen:
  962.         ==========
  963.  
  964.  
  965.         Bevor man sich an's Werk macht und riesige Files aus einer Mailbox
  966.         ausliest, sollte geprüft werden, ob das eigene Terminalprogramm
  967.         überhaupt in der Lage ist, 7PLUS-Files zu verarbeiten. Um dies zu
  968.         testen, dient die mit 7PLUS verteilte Datei ASC.TXT. Man spielt sie
  969.         einfach in die Mailbox an sich selbst adressiert ein und liest sie
  970.         wieder aus. Sieht die ausgelesene Datei nicht GENAUSO aus, wie das
  971.         Original, sind die Einstellungen des Terminalprogramms und TNC
  972.         gemäss obiger Hinweise im Abschnitt 'Tips:' zu überprüfen und der
  973.         Test gegebenenfalls zu wiederholen.
  974.  
  975.         Hat der Test geklappt, so kann man sich an das Auslesen von län-
  976.         geren 7PLUS-Files heranwagen.
  977.  
  978.         Die einfachste Möglichkeit, die Files mitzuschreiben, ist vorher
  979.         ein File auf Disk zu öffnen, und die eingehenden Daten fortlaufend
  980.         dort hineinschreiben zu lassen. Der Name des Files in dem mitge-
  981.         schrieben wird, sollte nach Möglichkeit nicht identisch mit dem
  982.         Namen der ausgelesenen 7PLUS-Files sein. Nehmen wir für folgende
  983.         Beispiele einfach den Namen 'savefile'.
  984.  
  985.         Hat man alle Files ausgelesen (man sollte daran denken, auch gleich
  986.         nach eventuell in der Box vorhandenen Korrekturfiles zu suchen!),
  987.         so muss man nun die einzelnen Files aus der Mitschrift extrahieren.
  988.         Hierzu kann man einen Editor benutzen oder - viel praktischer -
  989.         7PLUS selbst! 7PLUS kümmert sich dabei nicht nur um das Suchen und
  990.         Extrahieren der 7PLUS-Files, sondern auch um die korrekte Namens-
  991.         gebung.
  992.         Der Aufruf '7plus savefile -x' erledigt das Extrahieren der 7PLUS-
  993.         Files aus der Mitschrift.
  994.  
  995.         Nun stehen die 7PLUS-Files in dem Format auf Disk, in dem 7PLUS sie
  996.         erwartet und es kann das Dekodieren angegangen werden.
  997.  
  998.         Schauen wir uns mal an, was da auf der Disk alles entstanden ist:
  999.         (Diese Liste dient nur als Beispiel)
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.                                      Seite - 14
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.         TERM952.P01
  1014.         TERM952.P02
  1015.         TERM952.P03
  1016.         TERM952.P04
  1017.         TERM952.COR
  1018.  
  1019.         Aha, sehr gut.. Wir haben daran gedacht, auch gleich das in der
  1020.         Mailbox vorhandene Korrekturfile auszulesen.
  1021.  
  1022.         Um jetzt die Files zu dekodieren, gibt es zwei Möglichkeiten:
  1023.  
  1024.         '7plus term952.cor' <-- Korrektur durchführen.
  1025.         '7plus term952.p01' <-- Dekodieren.
  1026.  
  1027.         oder
  1028.  
  1029.         '7plus term952'     <-- 7PLUS macht beides selbst.
  1030.  
  1031.         Bei der zweiten Möglichkeit ist Vorsicht geboten, wenn sich im
  1032.         aktuellen Verzeichnis bereits eine Datei mit dem Namen 'TERM952'
  1033.         befindet. 7PLUS würde diese kodieren.... Daher mein Hinweis, den
  1034.         Namen des Savefiles anders zu wählen als die 7PLUS-Files.
  1035.  
  1036.         Wenn beim Dekodieren alles klargegangen ist, meldet 7PLUS dies:
  1037.  
  1038.         'Decoding succesful! 'term952.exe' 43210 Bytes.'
  1039.  
  1040.         TERM952.EXE ist nun das dekodierte Programm. Was man nun tun soll,
  1041.         hängt ganz von den Hinweisen des Einspielers des Programmes ab,
  1042.         zumindest habe ich als Autor von 7PLUS ab hier mit der Sache nichts
  1043.         mehr zu tun!
  1044.  
  1045.         Nehmen wir an, das Dekodieren hat nicht geklappt.
  1046.  
  1047.         7PLUS meldet:
  1048.  
  1049.         'Decoding not successful.
  1050.          Send error report 'term952.err' to originator of 'term952.exe'
  1051.          for correction.'
  1052.  
  1053.         Das bedeutet nichts anderes, als dass man nun das von 7PLUS erstel-
  1054.         lte Fehlerprotokoll 'TERM952.ERR' an den Einspieler der defekten
  1055.         Files schicken und auf das von ihm erstellte Korrekturfile warten
  1056.         soll...
  1057.  
  1058.         In der Vergangenheit haben mir einige OMs Fehlerprotokolle für
  1059.         Programme geschickt, die ich überhaupt nicht eingespielt habe. Um
  1060.         es nocheinmal deutlich zu sagen: derjenige, der eine Einspielung
  1061.         tätig, ist auch derjenige, an den die Fehlerprotokolle zu richten
  1062.         sind!!! Ich als Autor des dabei verwendeten Kodierers habe damit
  1063.         nichts zu tun! Vergleich: Ein Spedition liefert eine Ware fehler-
  1064.         haft aus. Niemand käme auf die Idee, den Hersteller des für den
  1065.         Transport benutzten Lastwagens zur Behebung des Schadens heran-
  1066.         zuziehen.
  1067.  
  1068.  
  1069.         Tips zum Einspielen ......:
  1070.         ===========================
  1071.  
  1072.         Wie im vorherigen Abschnitt sollte man sich vorher vergewissern,
  1073.         dass das eigene Terminalprogramm korrekt eingestellt ist und das
  1074.  
  1075.  
  1076.  
  1077.                                      Seite - 15
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.         korrekte Aussenden von 7PLUS-Files erlaubt. Ein Punkt, der hierbei
  1086.         ganz besonders wichtig ist, ist dass man daran denken muss, den
  1087.         eventuell eingeschalteten Umlautwandler auszuschalten! Vergisst man
  1088.         dies, so wird die Einspielung für die Katz sein, da sich die Files
  1089.         nicht mehr dekodieren lassen werden... Also spart den Anderen den
  1090.         unnötigen Frust und geht mit Bedacht an die Sache heran.
  1091.  
  1092.         Als allererstes sollte man einen kleinen Text schreiben, in dem
  1093.         erklärt ist, was sich hinter den Files verbirgt, die man da ein-
  1094.         spielt. Das ist für das spätere Auslesen sehr hilfreich, da man auf
  1095.         diese Weise schnell feststellen kann, ob das Programm überhaupt für
  1096.         einen interessant oder geeignet ist. Wichtig ist auch die Angabe
  1097.         des Systems, auf dem das Programm läuft (MS_DOS, AMIGA usw...) und
  1098.         welche Hardwarevorraussetzungen gegeben sein müssen (Herkules, VGA
  1099.         usw...). Auch sollte darauf hingewiesen werden, mit welchem Kom-
  1100.         pressor (LHARC, LHA, PKZIP...) das Programm evtl behandelt wurde
  1101.         und welche Dateien sich in dem Archiv befinden. Und last, but not
  1102.         least, welcher Kodierer benutzt wurde. In unserem Fall also 7PLUS.
  1103.         Die Überschrift, unter der man den Info-Text einspielt, sollte
  1104.         knapp gehalten sein und doch alle notwendigen Informationen
  1105.         enthalten, z.B.:
  1106.  
  1107.         'TERM952.EXE Info'
  1108.  
  1109.         Bei Einspielungen in Rubriken, bei denen nicht erkennbar ist, auf
  1110.         welches Rechnersystem sich die Files beziehen, ist es ratsam, dies
  1111.         in der Überschrift zu erwähnen:
  1112.  
  1113.         'TERM952.EXE Info (IBM)'
  1114.  
  1115.         So, jetzt geht's an's Kodieren. Dabei sollte man beachten, dass
  1116.         manche Mailboxen nur Files weiterleiten, die nicht grösser als 15k
  1117.         sind! Leider sind sich die Sysops der Mailbox in diesem Punkt wenig
  1118.         einig. Es gibt Mailboxen, die schon bei 5 oder 10k das Weiterleiten
  1119.         verweigern (Hier sollten sich die Sysops um Harmonisierung bemü-
  1120.         hen). Also muss man sich nun Gedanken machen, in wieviele Teile man
  1121.         das Programm kodiert.
  1122.  
  1123.         Nehmen wir an, TERM952.EXE hat einen Umfang von 43210 Bytes. Im
  1124.         kodierten zustand vergrössert sich die Datenmenge um ca. 11% auf ca
  1125.         48k. Beim Splitten (Aufteilen) in drei Teile würde die 15k-Grenze
  1126.         überschritten, also splitten wir in 4 Teile:
  1127.  
  1128.         '7plus term952.exe -sp 4'
  1129.  
  1130.         Nachdem 7PLUS mit dem Kodieren fertig ist, liegen die Files
  1131.         TERM952.P01 bis TERM952.P04 vor, die man nun einzeln einspielen
  1132.         kann. Auch hierbei sollte die Überschift mindestens so aussehen:
  1133.  
  1134.         'TERM952.P01 / 4 (7PLUS)'
  1135.  
  1136.         Was bedeutet: TERM952 ist mit 7PLUS kodiert, es ist der erste Teil
  1137.         einer vierteiligen Einspielung.
  1138.  
  1139.         Noch Informativer, für Newcomer aber eventuell etwas cryptisch:
  1140.  
  1141.         'TERM952.EXE.P01/04.7PL'
  1142.  
  1143.         Diesen Term liest man von Hinten her: Es ist ein 7PLUS-File, der
  1144.         erste Teil einer vierteiligen Einspielung und das resultierende
  1145.         Programm heisst TERM952.EXE.
  1146.  
  1147.  
  1148.  
  1149.                                      Seite - 16
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.         Nachdem man alles eingespielt hat, sollte man sich vergewissern, ob
  1159.         die Files auch gut in der Mailbox angekommen sind!! Denn bereits
  1160.         auf dem Weg in die Mailbox können sich schon Übertragungsfehler
  1161.         einschleichen. Sollten sich tatsächlich Fehler eingeschlichen
  1162.         haben, ist es nicht unbedingt notwendig, das betreffende File neu
  1163.         einzuspielen, sondern es genügt, wenn man ein entsprechendes
  1164.         Korrekturfile erstellt und einspielt.
  1165.  
  1166.         Und jetzt: Auf Korrekturanfragen warten.....
  1167.  
  1168.  
  1169.         Und noch was Allgemeines:
  1170.         =========================
  1171.  
  1172.         Ist ein 7PLUS-File in einer Mailbox defekt, so sollte man das File
  1173.         nach erfolgter Korrektur nicht neu einspielen, sondern lediglich
  1174.         das Korrekturfile. Da jeder die Korrektur ausführen lassen kann,
  1175.         ist eine komplette Neueinspielung völlig überflüssig und stellt
  1176.         lediglich eine unnötige Boxbelastung dar. Ausnahme: Das Netz
  1177.         arbeitet so zuverlässig, dass mitunter ganze Teile vernichtet
  1178.         werden, hi!(?).
  1179.  
  1180.         Wenn man 7PLUS-Files aus einer Mailbox ausliest, sollte man nach
  1181.         evtl in der Mailbox vorhandenen Korrekturfiles dazu umsehen. Man
  1182.         erspart dem Einspieler auf diese Weise eventuell einiges an Arbeit.
  1183.  
  1184.         Hat man ein Programm/Bild oder was auch immer mit Hilfe von 7PLUS
  1185.         eingespielt, so gehört es zum guten Ton, Fehlerprotokolle zu beant-
  1186.         worten. Wer sich generell weigert, Fehlerprotokolle zu beantworten,
  1187.         handelt wenig Ham-like und ist sich 'allgemeiner Beliebtheit'
  1188.         sicher, abgesehen davon, dass seine Einspielungen als Mailbox-
  1189.         leichen nutzlos herumliegen, weil niemand an die entsprechenden
  1190.         Korrekturdateien kommt...
  1191.  
  1192.         ...Es sei denn die Files haben die Reise durch das Netz überall
  1193.         unbeschadet überstanden...
  1194.  
  1195.         Das ist noch sehr selten der Fall. Die Regel ist leider, dass sich
  1196.         pro 10000 übertragene Zeichen mindestens ein Fehler einschleicht!
  1197.  
  1198.         Sollte einmal der schöne Tag eintreten, dass es keinerlei Fehler im
  1199.         Netz mehr gibt, bedeutet das nicht das Ende von 7PLUS, da dieser
  1200.         Kodierer inzwischen für die wichtigsten Rechnersysteme verfügbar
  1201.         ist und eine gute Basis für den Datenaustausch darstellt. Und
  1202.         kompakter als UUE oder RADIX95 sind 7PLUS-Files auch...
  1203.  
  1204.         73s, Axel in Bremerhaven, DG1BBQ @DB0CL
  1205.  
  1206.  
  1207.         P.S.: Tnx an Dietmar -DJ4RX- für seine Anregungen, an Lothar
  1208.               -DG3YFU-, und Dieter -DB7YAH- für ihre Tests bezüglich der
  1209.               Atari-Kompatibilität von 7PLUS und an DL4ZBH, DB5ZP bezüglich
  1210.               der AMIGA-Anpassungen. Und ich Danke meinem Freund Kai-Uwe
  1211.               -DE8KUG-, dass er mich zwei Tage lang ertragen hat und seinen
  1212.               AMIGA benutzen (missbrauchen) liess. Umsomehr, da sich 7PLUS
  1213.               zu Anfang als ganz toller GURU-Generator erwies und er schon
  1214.               um seine Festplatte bibberte. Aber so konnte ich endgültig
  1215.               herausfinden, warum 7PLUS auf dem AMIGA nicht so recht
  1216.               wollte. Dank auch an Torsten DF6NL für seine Anpassungen an
  1217.               UNIX. Fehlt nur noch MAC.....
  1218.  
  1219.  
  1220.  
  1221.                                      Seite - 17
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.                                      Seite - 18
  1294.  
  1295.